home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 51 / Amiga Format CD51 (2000-03-10)(Future Publishing)(GB)[!][issue 2000-04].iso / -in_the_mag- / pdselect / awnp / awnp-docs / button.doc < prev    next >
Text File  |  2000-02-16  |  4KB  |  185 lines

  1. Button gadget event
  2. -------------------------
  3.  
  4. 'gadget GID selected_state'
  5.  
  6. selected_state =0 not selected,!=0 selected
  7.  
  8. Button gadget parameters.
  9. -------------------------
  10.  
  11. font=GID
  12.  
  13. This sets the font for the gadget. The GID must point to an ALREADY defined text attribute.
  14.  
  15. close (c)
  16.  
  17.  This gadget will close the window when selected by the user.
  18.  
  19. readonly (ro)
  20.  
  21.  This gadget is read only.
  22.  
  23. disable=number (dis=)
  24.  
  25.  The gadget is disabled if number = 0 , enabled if number !=0. Defaults to enabled.
  26.  
  27. selected=number (s=)
  28.  
  29.   The gadget is selected if number != 0 , unselected if number = 0. Defaults to unselected.
  30.  
  31. autobutton=number (ab)
  32.  
  33.  This button uses a scaled glyph image. The number selects the glyph.
  34.  
  35. 0 POPFILE
  36. 1 POPDRAWER
  37. 2 POPFONT
  38. 3 CHECKBOX
  39. 4 CANCELBOX
  40. 5 UPARROW
  41. 6 DNARROW
  42. 7 RTARROW
  43. 8 LFARROW
  44. 9 POPTIME
  45. 10 POPSCREEN
  46. 11 POPUP
  47.  
  48. pushbutton  (pb)
  49.  
  50.  This button is a pushbutton.
  51.  
  52. gadgettext="text"  (gt=)
  53.  
  54.  Set the text of the gadget.
  55.  
  56. bevel=TYPE  (b=)
  57.  
  58.  Set the bevel type for this gadget.
  59. 0=NONE
  60. 1=THIN
  61. 2=BUTTON
  62. 3=GROUP
  63. 4=FIELD
  64. 5=DROPBOX
  65. 6=SBAR_HORIZ
  66. 7=SBAR_VERT
  67. 8=BOX
  68. 9=STANDARD
  69.  
  70. leftjustify  (lj)
  71. rightjustify (rj)
  72.  
  73.  Set the justification of the text for the gadget. Defaults to centerjustify.
  74.  
  75. minwidth=number  (minw=)
  76.  
  77.  Set the minimum width for this gadget
  78.  
  79. minheight=number (minh=)
  80.  
  81.  Set the minimum height for this gadget
  82.  
  83. weightedwidth=number   (weiw=)
  84.  
  85.  Set the weighted width for this gadget
  86.  
  87. weightedheight=number  (weih=)
  88.  
  89.  Set the weighted height for this gadget
  90.  
  91. nominalsize   (noms)
  92.  
  93.  Set this gadget to its nominal size.
  94.  
  95. useimage   (ui)
  96.  
  97.  Use the last defined image (bitmap/drawlist/penmap) as the gadgets image.
  98.  
  99. Anim="x|y|wide|high|offsetx|offsety|count"
  100.  
  101.  Use portions of a bitmap for this gadgets image(s).
  102. x,y              the left and top pixel of the first image.
  103. wide,high        the size of the images.
  104. offsetx,offsety  the offset to the next image.
  105. count            must be 0 for a standard two image button
  106.                  (normal and selected image)
  107.  
  108. The first image is the gadget graphic, the offset is to the
  109. selected image. offsets can be 0 to use a single image.
  110.  
  111. If count!=0 an array of images is produced to allow animation of the button.
  112. If count >0 an array of count images is built. The button image is set to
  113. the first image in the array.
  114. If count <0 an array of absolutevalue(count)*2 images is built. The button image is set to the first image in the array. The selected image is set to image absolutevalue(count)+1.
  115.  
  116. See the 'animimage' modify parameter for details about animating the button.
  117.  
  118.  
  119. FileName='path:file'
  120.  
  121.  A image file to use as the source bitmap for the anim data. If no file name is given an anim is given the bitmap from the previous anim will be reused. This bitmap in held in a buffer shared by bitmap images. See the image docs-bitmap for more info.
  122.  
  123. trans
  124.  
  125.  The animation background should be transparent if the image type allows it.
  126.  
  127. tags="tags|data[|tag|data...]|0
  128.  
  129.  A list of tag and value pairs in HEX. Do not forget the trailing null !
  130.  
  131. childlabel    (chl)
  132. childlabelr   (chlr)
  133.  
  134.  Use the previously defined image as a childlabel for this gadget. Display the childlabel to the right or left of the gadget.
  135.  
  136. replace=GID
  137.  
  138.  Use this gadget to replace an existing gadget specified by GID.
  139.  
  140. Definition Reply
  141. -----------------
  142.  
  143.  When the gadget creation is successful the pipe replies with
  144.  
  145. 'ok GID'
  146.  
  147. Button gadget modify parameters.
  148. -------------------------
  149.  
  150. readonly=number (ro=)
  151.  
  152.  The gadget is readonly if number = 1 , functional if number= 0. Note that this is different handling then in gadget definitions.
  153.  
  154. disable=number (dis=)
  155.  
  156.  The gadget is disabled if number = 0 , enabled if number != 0.
  157.  
  158. selected=number (s=)
  159.  
  160.   The gadget is selected if number != 0 , unselected if number = 0.
  161.  
  162. gadgettext="text"  (gt=)
  163.  
  164.  Set the text of the gadget.
  165.  
  166. newimage=number (ni=)
  167.  
  168.  Replace the gadget image with a previously defined image. If number =0 replace normal image, else replace selected image.
  169.  
  170. animimage=number  (ai=)
  171.  
  172.  When used with the 'newimage' keyword the button image is replaced with an image from the buttons image array. The image to be used is specified by number.
  173.  
  174. get=TAG
  175.  
  176.  Read the value of a specific gadget attribute. Returns a blank line if attribute is not readable. This should not be combined with any other modify command on the same line.
  177.  
  178. read
  179.  
  180.  returns the state of the button
  181.  
  182. refresh (ref)
  183.  
  184.  Redraw the gadget.
  185.